home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Magnum One
/
Magnum One (Mid-American Digital) (Disc Manufacturing).iso
/
d18
/
turbcomm.arc
/
TC.DOC
< prev
next >
Wrap
Text File
|
1989-06-30
|
9KB
|
216 lines
TURBOCOMM
A Terminal Emulation Program
by Stew Stryker, RONNIE Support Group
------------------------------------------------------------------------------
DISCLAIMER
The author and Digital Equipment Corp absolve themselves of any
possible warranties as to the capabilities of this program, the
contents of this document, and specifically disclaim any implied
warranties of effectiveness. They shall not be liable for any
lost profits, or for any claim or demand against them.
The program is donated to the public domain, and as such should
not be distributed for profit. The program is provided "as is"
and no technical support by Digital or the author should be
assumed.
------------------------------------------------------------------------------
INTRODUCTION
This terminal emulation program was written entirely in MS-DOS
Turbo Pascal (tm Borland International) for the DEC Rainbow. It's
main purpose is to act as an example program showing how to use
the MS-DOS communication library. Its secndary purpose is to
provide support for ReGIS emulation in the Digital A-to-Z environ-
ment. It requires MS-DOS 2.05 or greater to run.
FEATURES
Along with providing basic terminal emulation capabilities, this
package supports:
* User selection of baud rate on program startup
* Directing characters received from the host to the local printer
* Sending text files to the host computer
* Receiving text files from the host computer
* User selection of either VT2xx or VT102 emulation
* Digital's A-to-Z video graphics requirements
* ReGIS terminal emulation software
* Terminal Identification inquiries
* Full function key support
* Enter and save your own function key definitions
* Commands to change Numeric Keypad mode
* Terminal resets escape sequence trapping
* Printer controller commands
* Responding correctly to Printer Status Inquiries
* The Break key
DIRECTIONS
STARTING THE PROGRAM:
type:
TC
{T} {VT102} {baud rate}<CR>
The braces {} in the command line indicate that those portions are
optional.
The 'T' indicates that you wish to go immediately into
T
erminal
emulation mode, by-passing the initial help display.
The default terminal emulation mode is a VT2xx. You may select
VT102 emulation by typing 'VT102' in the command line.
The 'baud rate' selects the baud rate you want the program to run
at (which, of course, must be compatible with your modem or data
line). The baud rate may be one of the following:
110 150 300 600 1200 2400 4800 9600
If no baud rate is selected, the program uses your default
communications settings (established in the Rainbow Setup mode).
The program first displays help information on how to use the
function keys. At this point, you either press <DO> to enter
terminal emulation mode, <HELP> for more information, or <EXIT> to
return to the operating system.
For example, to start the program running at 1200 baud instead of
your default baud rate, and skipping over the initial display,
type:
TC T 1200
<CR>
TO USE THE FUNCTION KEYS
ONCE YOU ARE IN TERMINAL EMULATION:
All the function keys, except <PRINT SCREEN>, <BREAK> and <F4>,
will transmit their standard escape sequences to your host
computer.
<BREAK> will send a break signal for .25 seconds.
<F4> puts you in command mode for a single command.
<PRINT> does nothing.
COMMAND MODE:
From terminal emulation mode, press the
<F4>
key, followed
by the letter highlighted for the function you want:
C
lose - If you are receiving a text file from the
host computer, this will stop receiving the
text, and close the file. When you've success-
fully closed the file, your screen will flash.
D
isconnect - Drops the DTR signal to your modem, which
will hang up your phone.
P
rinter - Toggles sending the displayed text to your
printer on and off.
Q
uit - Disconnect and exit.
R
eceive - Allows you to capture all characters from
your host onto a file on your Rainbow.
S
end - Lets you send a text file from your Rainbow
to your host computer.
e
X
it - Ends running TurboComm. This does not drop
your DTR signal, so that your modem may still be con-
nected to your host computer.
If you type any other character, besides those listed above, a
line of help text will be displayed.
You can also define most of the function keys on your keyboard,
including:
INTERRUPT FIND F17
RESUME INSERT F18
CANCEL REMOVE F19
MAIN SCREEN SELECT F20
EXIT PREV SCREEN HELP
ADDTNL OPTIONS NEXT SCREEN DO
These keys are defined from the command mode, by pressing the
function key you wish to redefine. You then type in your
definition, and press <F4> to end the definition. A definition
may contain any sequence of less than 80 keyboard characters.
When you exit TurboComm, you will be asked if you wish to save the
definitions. If so, you will be prompted for a filename, with
TC.KEY as the default. If you have defined a default function key
directory (see below), the file will be created in that directory,
otherwise, it will be created in the current directory.
The next time you start up TurboComm, the function key definition
file will be loaded automatically.
DEFINING A DEFAULT FUNCTION KEY DIRECTORY
With the latest version of TurboComm, you can define a default
directory for your function key definitions. TurboComm will read
the MS-DOS Environmental Variable 'TC_DIR' for the name of the
directory you keep your key definition files. This will be used
for both the default function key file, as well as any you might
use on the TC command line. That is, if you define TC_DIR,
all
your function key definition files must reside there.
For example, type:
SET TC_DIR=E:\COMMAND
would cause TC to look for TC.KEY in E:\COMMAND subdirectory.
TO COMPILE TURBOCOMM SOURCE CODE
(You can run TC.COM directly, without recompiling the source code.
If you want to modify the program yourself, you'll need these
instructions.)
First, you must break the library file, TC.LBR, into its separate
files with the LU.EXE utility (not included). To break out all
the components, type:
LU A TC.LBR<cr>
Next, you will probably want to edit the main file (TC.PAS) to
match the version of MS-DOS Turbo Pascal you're using. This was
originally developed under Turbo Pascal version 2.0. At the last
minute, my update to 3.0 arrived and I modified some of the
procedures to take advantage of some new capabilities. Therefore
some of the code requires Turbo Pascal 3.0 or greater.
I did the only decent thing, and left the version 2.0 code in the
program, but commented it out. If you're compiling with Turbo
3.0, you can compile this "as is" (Though you may want to remove
the version 2.0 code altogether.) If you are still using Turbo
2.0, search through the source code in TC.PAS for all occurances
of 'Turbo Pascal 3.0', and remove those routines. Then search for
the sections marked with '< 3.0' and remove the comment marks ( {}
), to activate those functions.
After you've created the version of TC.PAS you need, you simply
compile it as you would any other Turbo Pascal program.